.\" Drawpile is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\" 
.\" Drawpile is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with Drawpile.  If not, see <http://www.gnu.org/licenses/>.
.
.TH DRAWPILE-SRV 1 "2017" "drawpile-srv" "Drawpile standalone server"
.
.SH NAME
drawpile-srv \- Drawpile server
.
.SH SYNOPSIS
.
.B drawpile-srv
[\fIOPTIONS\fR]
.
.SH DESCRIPTION
A standalone server for Drawpile.
.
.SH OPTIONS
.
.TP
.BR --help , \ -h
show help text
.TP
.BR --version , \ -v
prints program version number
.TP
.BR --gui\ 
run in graphical mode (used with GUI specific command line arguments)
.TP
.BR --port , \ -p\  port
listen on the specified port instead of the default.
.TP
.BR --listen , \ -l\  address 
bind to the specified address. If no listening address is specified,
drawpile-srv will listen on all addresses.
.TP
.BR --local-host\  hostname
local server hostname to use in session announcement
.TP
.BR --record , \ -r\  filename\ pattern
record sessions to files. Placeholders in the filename pattern will be expanded
to generate the actual filename. If a directory is given, a default filename pattern
will be used. The placeholders %d (date), %t (time) and %i (session ID) are supported.
.TP
.BR --sessions\  path
where to store file backed sessions. If not specified, sessions are kept in memory.
.TP
.BR --ssl-cert\  cert.pem
select SSL certificate file.
.TP
.BR --ssl-key\  key.pem
select SSL private key file. This must be used together with
.B --ssl-cert
to enable SSL support.
.TP
.BR --secure , \ -S
strict security mode. When this flag is set, clients must use SSL to log in.
.TP
.BR --database\  path
the configuration database to use
.TP
.BR --config , \ -c \  path
the configuration file to use. Mutually exclusive with --database.
.TP
.BR --templates , \ -t\  path
where to look for session templates
.TP
.BR --web-admin-port\  port  
enable web admin API and listen on this port
.TP
.BR --web-admin-auth\  username:password  
enable HTTP BASIC Authentication on web admin API
.TP
.BR --web-admin-access\  address/subnet|all 
allow access to web admin API from hosts other than localhost

.
.SH SOCKET ACTIVATION
.
Drawpile-srv supports systemd socket activation. When the server is started by systemd and a socket is passed, the parameters
--listen, --port and --web-admin-port are ignored. The listening address must be configured in drawpile-srv.socket unit file.
If two sockets are passed, the second one will be used for the web admin API.

.
.SH AUTHOR
.
Written by Calle Laakkonen <laakkonenc@gmail.com>.
.
.SH COPYRIGHT
.
Copyright \(co 2013-2017 Calle Laakkonen <laakkonenc@gmail.com>
.br
This is Free Software; this software is licensed under the GPL version 3, as published by the Free Software Foundation.
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

